home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / a_man / cat7 / connld.z / connld
Encoding:
Text File  |  2002-10-03  |  4.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ccccoooonnnnnnnnlllldddd((((7777))))                                                            ccccoooonnnnnnnnlllldddd((((7777))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _cccc_oooo_nnnn_nnnn_llll_dddd - line discipline for unique stream connections
  10.  
  11. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  12.      _cccc_oooo_nnnn_nnnn_llll_dddd is a STREAMS-based module that provides unique connections between
  13.      server and client processes.  It can only be pushed (see _ssss_tttt_rrrr_eeee_aaaa_mmmm_iiii_oooo(7))
  14.      onto one end of a STREAMS-based pipe that may subsequently be attached to
  15.      a name in the filesystem name space.  After the pipe end is attached, a
  16.      new pipe is created internally when an originating process attempts to
  17.      _oooo_pppp_eeee_nnnn(2) or _cccc_rrrr_eeee_aaaa_tttt(2) the filesystem name.  A file descriptor for one end
  18.      of the new pipe is packaged into a message identical to that for the
  19.      _iiii_oooo_cccc_tttt_llll _IIII______SSSS_EEEE_NNNN_DDDD_FFFF_DDDD (see _ssss_tttt_rrrr_eeee_aaaa_mmmm_iiii_oooo(7)) and is transmitted along the stream to
  20.      the server process on the other end.  The originating process is blocked
  21.      until the server responds.
  22.  
  23.      The server responds to the _IIII______SSSS_EEEE_NNNN_DDDD_FFFF_DDDD request by accepting the file
  24.      descriptor through the _IIII______RRRR_EEEE_CCCC_VVVV_FFFF_DDDD _iiii_oooo_cccc_tttt_llll message.  When this happens, the
  25.      file descriptor associated with the other end of the new pipe is
  26.      transmitted to the originating process as the file descriptor returned
  27.      from _oooo_pppp_eeee_nnnn(2) or _cccc_rrrr_eeee_aaaa_tttt(2).
  28.  
  29.      If the server does not respond to the _IIII______SSSS_EEEE_NNNN_DDDD_FFFF_DDDD request, the stream that
  30.      the _cccc_oooo_nnnn_nnnn_llll_dddd module is pushed on becomes uni-directional because the server
  31.      can not retrieve any data off the stream until the _IIII______RRRR_EEEE_CCCC_VVVV_FFFF_DDDD request is
  32.      issued.  If the server process exits before issuing the _IIII______RRRR_EEEE_CCCC_VVVV_FFFF_DDDD request,
  33.      the _oooo_pppp_eeee_nnnn(2) or the _cccc_rrrr_eeee_aaaa_tttt(2) system calls will fail and return -1 to the
  34.      originating process.
  35.  
  36.      When the _cccc_oooo_nnnn_nnnn_llll_dddd module is pushed onto a pipe, messages going back and
  37.      forth through the pipe are ignored by _cccc_oooo_nnnn_nnnn_llll_dddd.
  38.  
  39.      On success, an open of _cccc_oooo_nnnn_nnnn_llll_dddd returns 0.  On failure, _eeee_rrrr_rrrr_nnnn_oooo is set to the
  40.      following values:
  41.  
  42.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL       A stream onto which _cccc_oooo_nnnn_nnnn_llll_dddd is being pushed is not a pipe or
  43.                   the pipe does not have a write queue pointer pointing to a
  44.                   stream head read queue.
  45.  
  46.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL       The other end of the pipe onto which _cccc_oooo_nnnn_nnnn_llll_dddd is being pushed
  47.                   is linked under a multiplexor.
  48.  
  49.      _EEEE_PPPP_IIII_PPPP_EEEE        _cccc_oooo_nnnn_nnnn_llll_dddd is being pushed onto a pipe end whose other end is no
  50.                   longer there.
  51.  
  52.      _EEEE_NNNN_OOOO_MMMM_EEEE_MMMM       An internal pipe could not be created.
  53.  
  54.      _EEEE_NNNN_XXXX_IIII_OOOO        An _MMMM______HHHH_AAAA_NNNN_GGGG_UUUU_PPPP message is at the stream head of the pipe onto
  55.                   which _cccc_oooo_nnnn_nnnn_llll_dddd is being pushed.
  56.  
  57.      _EEEE_AAAA_GGGG_AAAA_IIII_NNNN       Internal data structures could not be allocated.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ccccoooonnnnnnnnlllldddd((((7777))))                                                            ccccoooonnnnnnnnlllldddd((((7777))))
  71.  
  72.  
  73.  
  74.      _EEEE_NNNN_FFFF_IIII_LLLL_EEEE       A file table entry could not be allocated.
  75.  
  76. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  77.      streamio(7).
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.